Skip to content

docs: sync production-readiness (sdk + airaccount-contract + sp + kms) into consolidated doc#430

Merged
jhfnetboy merged 8 commits into
masterfrom
docs/sync-sdk-production-readiness
Jul 9, 2026
Merged

docs: sync production-readiness (sdk + airaccount-contract + sp + kms) into consolidated doc#430
jhfnetboy merged 8 commits into
masterfrom
docs/sync-sdk-production-readiness

Conversation

@jhfnetboy

Copy link
Copy Markdown
Member

Folds repo:sdk's CC-30 production-readiness reply into docs/PRODUCTION_READINESS.md (the consolidated ecosystem doc I maintain).

Changes

  • repo:sdk section filled (was ⏳ placeholder) — 12-row table for @aastar/sdk 0.39.4.
  • Testnet gate: sdk ✅ — no SDK blocker (core API + two-testnet canonical 11155111/11155420 + ABI all ready).
  • Mainnet gate: added SDK's key finding — CANONICAL_ADDRESSES covers only the two testnet chainIds; mainnet (1/10) is not wired, blocked on the 4 contract repos' mainnet deploys (CC-18 two-phase). Plus SDK mainnet TODOs (CC-13 batch-B Timelock wrapper, Build(deps): Bump react from 19.2.0 to 19.2.4 in /aastar-frontend #256 GuardChecker WA precheck, Build(deps): Bump react from 19.1.1 to 19.2.0 in /aastar-frontend #163 buyGasless).
  • Dependency matrix: filled sdk→kms (HTTP openapi) + noted sdk needs contract repos' mainnet addresses.
  • Flagged the impact on YAAA's "network switch" row (SDK-canonical-follows-chain holds for testnet only).

Source: CC-30 [repo:sdk] (2026-07-09). Still pending: kms / airaccount-contract / sp / dvt.

https://claude.ai/code/session_01RajETCvboSvhadpqMbekNx

Folds repo:sdk's CC-30 reply into docs/PRODUCTION_READINESS.md:
- repo:sdk section filled (12-row table, @aastar/sdk 0.39.4).
- Testnet gate: sdk ✅ (no SDK blocker — core API + two-testnet canonical + ABI ready).
- Mainnet gate: added SDK's finding — CANONICAL_ADDRESSES covers only the two
  testnet chainIds; mainnet (1/10) not wired, blocked on the 4 contract repos'
  mainnet deploys (CC-18 two-phase); plus SDK mainnet TODOs (CC-13 batch B
  Timelock wrapper, #256 GuardChecker WA precheck, #163 buyGasless).
- Dependency matrix: filled the sdk→kms cell (HTTP openapi) + noted sdk needs
  the contract repos' mainnet addresses.
- Flagged the impact on YAAA's "network switch" item (SDK-canonical-follows-chain
  holds for testnet only).

Source: CC-30 [repo:sdk] 2026-07-09. 4 dependency repos (kms/airaccount-contract/
sp/dvt) still pending.

Claude-Session: https://claude.ai/code/session_01RajETCvboSvhadpqMbekNx
@jhfnetboy jhfnetboy requested a review from fanhousanbu as a code owner July 9, 2026 07:16
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@clestons clestons left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

#430 — APPROVE

将 CC-30 [repo:sdk] 的回帖同步进 docs/PRODUCTION_READINESS.md:sdk 行补完 12 项评估表格,测试网门标为 ✅,主网门列出三个必补项(mainnet canonical 未接入、#256 WA 预检、#163 buyGasless),依赖矩阵的 sdk 行从 ? 填为实际内容,并在主网发布门添加 YAAA「网络切换假设」的影响说明。内容与 CC-30 记录一致,无遗漏。

纯文档,无代码变更。

DOCS-track. PK skipped.

jhfnetboy added 2 commits July 9, 2026 14:46
…done)

SDK posted a correction + progress on CC-30:
- CORRECTION: mainnet chain 10 IS in canonical (listSupportedChainIds =
  [10,11155111,11155420]); my earlier "mainnet not wired" was wrong. The real
  blocker (G1) is that OP-Mainnet canonical points at the OLD V3 stack
  (SuperPaymaster 3.2.2 / Registry 3.0.2) while SDK/testnet is V5.4.2 — mainnet
  needs a full V5.4.2 redeploy.
- Reframed the sdk section as a G1–G10 gap table with owners; mainnet gate now
  leads with G1 (V3→V5 redeploy) + G5 (DVT mainnet nodes).
- G2/G3/G4 (check:abi + check:abi-drift REDs: LivenessRegistry,
  AAStarBLSKeyRegistry, CC-28 xPNTs caps, Paymaster/Registry drift) are DONE
  (branch feat/abi-sync-cc28-cc29-liveness); gates green, core 471 + paymaster 20
  + tokens 20 tests pass.
- Corrected YAAA "network switch" note: mainnet isn't just an RPC change — SDK
  canonical still points at V3, so it gates on upstream V5 mainnet deploy.

Source: CC-30 [repo:sdk] 81f3592c + 1f63acba.

Claude-Session: https://claude.ai/code/session_01RajETCvboSvhadpqMbekNx
… doc

Folds repo:airaccount-contract's CC-30 reply (7a0a6d29) into the consolidated
doc (bundled into this open rolling sync PR to avoid conflicting edits on the
shared gate/matrix/header lines):
- airaccount-contract section filled (v0.27.0): testnet beta shippable
  (Sepolia, 900 forge + 16-stage E2E green); mainnet GA blocked on external
  audit #29 (hard gate), mainnet deploy script/Safe/keystore, cross-repo
  two-network readiness (@DVT validator+nodes / @sp aPNTs / @kms keys), and
  Etherscan verify (9 pending).
- Testnet gate: airaccount-contract ✅.
- Mainnet gate: added the external-audit GA hard-gate line.
- Matrix: filled airaccount-contract row (depends on kms/sp/dvt).

Source: CC-30 [repo:airaccount-contract] 7a0a6d29 (their repo PR #183).

Claude-Session: https://claude.ai/code/session_01RajETCvboSvhadpqMbekNx
@jhfnetboy jhfnetboy changed the title docs: sync sdk production-readiness into consolidated doc docs: sync production-readiness (sdk + airaccount-contract) into consolidated doc Jul 9, 2026
Folds repo:sp's CC-30 reply (bc90cc99) into the rolling sync PR:
- sp section filled (v5.4.2): testnet 🟢 SP has ZERO blockers and can support
  YAAA's testnet release (V5.4.2 + CC-28 over-issuance guard + CC-29
  LivenessRegistry all on Sepolia, 1156 tests). Mainnet 🔴: G1 (mainnet still
  V3, confirms SDK), mainnet config/multisig, slashPolicyAdmin→Safe (CC-31),
  aPNTs mainnet + funding, external audit.
- Testnet gate: sp ✅.
- Mainnet gate: added the SP CC-31 (slashPolicyAdmin→Safe) line — noting it
  also unlocks YAAA's governance write-side E2E (#427).
- Matrix: filled sp row (depends on dvt/airaccount-contract/kms).
- Noted the CC-31 linkage in the sp section (SP handoff == the timelock handoff
  YAAA's #427 E2E waits on).

Source: CC-30 [repo:sp] bc90cc99 (their repo PR #350).

Claude-Session: https://claude.ai/code/session_01RajETCvboSvhadpqMbekNx
@jhfnetboy jhfnetboy changed the title docs: sync production-readiness (sdk + airaccount-contract) into consolidated doc docs: sync production-readiness (sdk + airaccount-contract + sp) into consolidated doc Jul 9, 2026
Folds repo:kms's CC-30 reply (5e92032a) into the rolling sync PR:
- kms section filled (v0.28.1): testnet shippable now (only config→Sepolia,
  E2E 41/41 green). Mainnet blocked on 4 hardware-security items
  (#99/#50/#127/#128 — RPMB/secure-boot/final security review/key custody +
  incident plan). CC-22/CC-24 KMS+DVT co-located baseline ready pending @DVT
  build-path + light integration. Production topology: 1 KMS + 3 DVT (2-of-3).
- Testnet gate: kms ✅ (board provisioning arrives in a day or two).
- Mainnet gate: added the KMS hardware-security line.
- Matrix: filled kms row (depends on airaccount-contract/sp/dvt/sdk).

Note: the kms→dvt task list (a9b6b457) is a cross-repo request, not a dvt
self-assessment, so the dvt section stays ⏳ pending dvt's own reply.

With this, 5 of 6 repos report testnet-ready (yaaa+sdk+airaccount-contract+sp+kms);
only dvt's own table remains.

Source: CC-30 [repo:kms] 5e92032a.

Claude-Session: https://claude.ai/code/session_01RajETCvboSvhadpqMbekNx
@jhfnetboy jhfnetboy changed the title docs: sync production-readiness (sdk + airaccount-contract + sp) into consolidated doc docs: sync production-readiness (sdk + airaccount-contract + sp + kms) into consolidated doc Jul 9, 2026
jhfnetboy added 3 commits July 9, 2026 17:45
…ress

Two new CC-30 updates folded into the rolling sync PR:

sdk (353eb50e) — published @aastar/sdk 0.40.0 (PR #303/#304, Codex 3-round
APPROVE). All independent (non-upstream-mainnet) gaps closed:
- G6 CC-13 batch-B slash Timelock → shipped v0.39.3
- G7 #256 GuardChecker WA algId → shipped v0.37.1 (issue closed)
- G9 #176 ERC20 part1 → 0.40.0 (getTokenGuardState real read + resolveTokenTier
  + fixed a latent token/account tier-semantics bug affecting guardian co-sign);
  part2 (Tier-3 guardian ECDSA collection) still needs guardian E2E
- G10 → 0.40.0 (deleted stale config.optimism.json; chain-10 authoritative =
  config.op-mainnet.json)
- Gates all green; core 471 + airaccount 872 tests. Remaining mainnet: G1/G5
  (upstream V5 deploy + DVT mainnet nodes) + G8 #163 + #176 part2. Noted the
  ABI/address sync is a moving snapshot (re-run after upstream stabilizes).
- Testnet gate: sdk now ✅ published.

kms (4f0e597a) — device-arrival software prep done: #122 CA/TA gate hardened,
3-node config + runbook ready (kms/deploy/topology-aastar-3node), DK2 handoff to
dvt. Conclusion unchanged (testnet shippable; mainnet still #99/#50/#127/#128).

Source: CC-30 [repo:sdk] 353eb50e + [repo:kms] 4f0e597a.

Claude-Session: https://claude.ai/code/session_01RajETCvboSvhadpqMbekNx
… alignment

Two new CC-30 updates folded into the rolling sync PR:

sp (8195df64) — SP's independent items all landed (not waiting on external):
- Mainnet deploy runbook + config authoritative + CC-14 naming + CheckVersions
  chain-10 fix (PR #351). config.op-mainnet.json = authoritative V5;
  ./deploy-core op-mainnet --fresh-deploy is the one-command V5.4.2 path.
- #285 applyBLSAggregator confirmed done (BLS_AGGREGATOR==0xF51c…8B13 on Sepolia).
- G10 SP-side done (optimism.json marked legacy-V3), aligned with SDK 0.40.0.
- SP conclusion: testnet zero-blocker; mainnet is now pure external gates
  (audit + keystore + @DVT mainnet nodes) — "one command once audit passes".

sdk (519cc3d8) — acknowledges SP alignment: G10 consistent, G1 handoff protocol
confirmed, SP core ABI frozen at 5.4.2 (moving-snapshot narrowed to addresses
only). Adds CC-31 community Safe 0x51eDf11f… as canonical COMMUNITY_SAFE
(slashPolicyAdmin/owner target), landing with G1 mainnet integration.

Reflected in the sp section, sdk conclusion, and the mainnet gate (CC-31 Safe
address + SP runbook ready).

Source: CC-30 [repo:sp] 8195df64 + [repo:sdk] 519cc3d8.

Claude-Session: https://claude.ai/code/session_01RajETCvboSvhadpqMbekNx
…s closed

repo:kms update (2e9e5afe): pre-arrival software work now merged to main —
#122 CA/TA gate (PR #166) + 3-node topology profiles/runbook/readiness (PR
#167). SP dependencies (#285 applyBLSAggregator, #139 slash) confirmed closed
from KMS's side. KMS's only remaining non-hardware dependency is now @DVT
(DK2 script / CC-22 build+validator / CC-24 TEE custody / release), plus a
one-time TEE BLS pubkey re-registration by @airaccount-contract before mainnet.
Conclusion unchanged (testnet shippable; mainnet still #99/#50/#127/#128).

Source: CC-30 [repo:kms] 2e9e5afe.

Claude-Session: https://claude.ai/code/session_01RajETCvboSvhadpqMbekNx
@jhfnetboy jhfnetboy merged commit 5baa2e1 into master Jul 9, 2026
14 checks passed
@jhfnetboy jhfnetboy deleted the docs/sync-sdk-production-readiness branch July 9, 2026 14:58
@github-actions github-actions Bot locked and limited conversation to collaborators Jul 9, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants